home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / printing / rlpr-1.000 / rlpr-1 / rlpr-1.13 / INSTALL < prev    next >
Text File  |  1996-06-30  |  5KB  |  158 lines
  1. This is a public release of rlpr 1.13
  2. $Id: INSTALL,v 1.3 1996/07/01 01:03:51 meem Exp $
  3.  
  4. For details on getting started with rlpr please see the accompanying README
  5.  
  6. Please report any bugs, suggestions, etc, to meem@gnu.ai.mit.edu
  7. Copyright (c) 1996 meem, meem@gnu.ai.mit.edu
  8.  
  9. This program is free software; you can redistribute it and/or modify
  10. it under the terms of the GNU General Public License as published by
  11. the Free Software Foundation; either version 1, or (at your option)
  12. any later version.
  13.  
  14. This program is distributed in the hope that it will be useful,
  15. but WITHOUT ANY WARRANTY; without even the implied warranty of 
  16. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17. General Public License for more details.
  18.  
  19. INSTALLATION INSTRUCTIONS
  20. =========================
  21.  
  22. There are different instructions depending on whether you are a
  23. sysadmin installing the rlpr client, or a mortal user installing the
  24. rlpr client (and maybe the rlprd proxy agent).  Please follow the
  25. appropriate one:
  26.  
  27.  
  28. FOR SYSADMINS INSTALLING RLPR
  29. =============================
  30.  
  31. on your machine, in the directory with the untarred rlpr distribution:
  32.  
  33. 1. set the BINDIR and MANDIR variables in the Makefile to reflect your
  34.    system configuration.
  35.  
  36. 2. change the PERM variable in the Makefile to be 4755
  37.  
  38. 3. build the rlpr binary:
  39.    % make rlpr
  40.  
  41. 4. su to root.
  42.  
  43. 5. install the rlpr binary, and associated rlpr and rlprrc manpages:
  44.    # make install
  45.  
  46. Users can now use rlpr to print to machines running lpd from your
  47. machine by running the rlpr client. They will need to configure rlpr
  48. to know about the machine and printqueue they wish to print to -- this
  49. information is available by reading rlpr(1) and README.
  50.  
  51.  
  52. FOR CONVENTIONAL USERS INSTALLING RLPR 
  53. ======================================
  54.  
  55. This setup is much more painful to get installed correctly, but no
  56. more difficult to use once configured appropriately.  This
  57. configuration is intended for users who wish to print from a machine
  58. they do not have root access on to another machine on their network
  59. (probably the internet) -- please follow the instructions CLOSELY.
  60.  
  61. If you are installing rlpr this way, it is REQUIRED that you or
  62. someone you know is running an rlprd proxy as root on some machine on
  63. your network. If your network is the Internet, the closer the rlprd is
  64. to you geographically, the better.
  65.  
  66. If the machine you wish to print _to_ is running UNIX and you have
  67. root access on it, it is recommended you install a local rlprd.
  68.  
  69. In any case, the following is MANDATORY:
  70.  
  71.    1. You must install the rlpr client on the machine you wish to
  72.       print from.  Details on how to do this are below.
  73.  
  74.    2. The machine you wish to print to must be configured to allow
  75.       connections from the machine running the rlprd proxy. under
  76.       UNIX, this usually involves editing the local machine's
  77.       /etc/hosts.lpd file. 
  78.  
  79.       If the proxy (the machine running the rlprd) is the same machine
  80.       as the final destination, you have to put an entry for your own
  81.       machine in the /etc/hosts.lpd
  82.  
  83.       How to do this is beyond the scope of this documentation.
  84.     
  85.       Note that anyone print to your printer if they know the proxy
  86.       you trust, your printer name and your hostname, This is because
  87.       the proxy trusts everyone, and traditional Bezerkeley lpd has
  88.       lame host-based security.
  89.       IF THIS BOTHERS YOU, DO NOT USE RLPR THIS WAY.
  90.  
  91.       
  92. INSTALLING THE RLPR CLIENT ON THE MACHINE YOU WISH TO PRINT FROM (MANDATORY)
  93. ============================================================================
  94.  
  95. on that machine:
  96.  
  97. 1. if you don't already have a private bin directory, create one:
  98.    % mkdir ~/bin
  99.  
  100. 2. if you don't already have a private manpage directory, create one:
  101.    % mkdir ~/man
  102.    % pushd ~/man
  103.    % mkdir man1 man2 man3 man4 man5 man6 man7 man8 man9
  104.    % popd
  105.  
  106. 3. add these to your environment, traditionally by editing your .login:
  107.    for csh or tcsh, do:
  108.      % touch ~/.login
  109.      % cat >> ~/.login
  110.      setenv PATH "~/bin:$PATH"
  111.      setenv MANPATH "~/man:$MANPATH"
  112.      ^D
  113.    for sh or bash, do:
  114.      $ touch ~/.login
  115.      $ cat >> ~/.login
  116.      PATH="~/bin:$PATH"; export PATH
  117.      MANPATH="~/man:$MANPATH"; export MANPATH
  118.      ^D
  119.  
  120. in the directory with the untarred rlpr distribution:
  121.  
  122. 4. set the BINDIR and MANDIR variables in the Makefile to be ${HOME}/bin and
  123.    ${HOME}/man respectively.
  124.  
  125. 5. build the rlpr binary:
  126.    % make rlpr
  127.  
  128. 6. install the rlpr binary, and associated rlpr and rlprrc manpages:
  129.    # make install
  130.  
  131.  
  132. INSTALLING THE RLPRD PROXY ON A MACHINE YOU HAVE ROOT ACCESS ON (OPTIONAL)
  133. ==========================================================================
  134.  
  135. If you already know the IP address of a proxy agent, this step is not
  136. required -- however, if you can install an rlprd proxy, it is
  137. recommended since it will yield better performance.
  138.  
  139. If you do not need AND do not want to install a proxy, please proceed
  140. to the README for how to get started with rlpr.
  141.  
  142. on your machine, in the directory with the untarred rlpr distribution:
  143.  
  144. 1. set the BINDIR and MANDIR variables in the Makefile to reflect your
  145.    system configuration.
  146.  
  147. 2. change the PERM variable in the Makefile to be 4755
  148.  
  149. 3. build the rlprd binary:
  150.    % make rlprd
  151.  
  152. 4. su to root.
  153.  
  154. 5. install the rlprd binary, and associated rlprd manpage:
  155.    # make install-rlprd
  156.  
  157. proceed to the README for info on getting started
  158.